home *** CD-ROM | disk | FTP | other *** search
/ Ian & Stuart's Australian Mac 1 / Ian and Stuart's One (Australia).iso / Australasian Legends / Commercial / Rainbow Hill / MacDOS™ 2.0.0 / User's Guide / A.1 Errors (A-M) < prev    next >
Text File  |  1994-09-20  |  27KB  |  565 lines
  1. A  Error Codes
  2.  
  3.        This  section provides a full list of all error and  warning
  4.        messages  displayed by MacDOS. The messages  are  listed  in
  5.        alphabetical  order and preceded by the corresponding  error
  6.        or warning code.
  7.  
  8.        Note  that the error codes are only visible when errors  and
  9.        warnings  are reported with alert boxes (ie. after executing
  10.        ALARM ON).
  11.  
  12.        If  you detect a bug or an undocumented error, please inform
  13.        Rainbow Hill immediately.
  14.  
  15. Errors
  16.        Attempted to open too many files  (E32)
  17.            MacDOS  attempted to open more files  that  the  Mac  OS
  18.            allows.  This is usually due to a high "depth" of  batch
  19.            CALLs  combined  with file copying, output  redirection,
  20.            and logging.
  21.            Suggested actions:
  22.            •  Reduce   the  maximum  "depth"  of  batch  CALLs   by
  23.               serialising  calls  whenever  possible.  If  you  are
  24.               copying  files  within the "deepest"  batch  program,
  25.               split  the  copying of data and resource  forks  into
  26.               two separate commands.
  27.  
  28.        Bad command or file name  (E41)
  29.            MacDOS could not make sense of your command.
  30.            You  probably  mistyped  a  command,  or  attempted   to
  31.            execute a program which MacDOS could not find.
  32.            Perhaps  you  typed a "pipe" at the end  of  a  command,
  33.            attempted to run interactively a command which  is  only
  34.            legal   in  batch  mode,  or  typed  a  badly  formatted
  35.            command.
  36.            Suggested actions:
  37.            •  Check that the command name is correct.
  38.            •  If  you  were trying to run a program, check  whether
  39.               the  batch or application file exists. Also type  the
  40.               command  PATH and check that it lists all the folders
  41.               that you expect to find there.
  42.            •  If  you  typed a command, check that it is  legal  in
  43.               interactive mode.
  44.            •  Check  that you have not omitted any compulsory token
  45.               in complex commands like IF, DECR, etc.
  46.            •  If  you  started  the command with a  MacDOS  filter,
  47.               check that you redirected its input.
  48.  
  49.        Bad switch  (E28)
  50.            You entered a command with a badly formatted switch.
  51.            Suggested actions:
  52.            •  Use   the  on-line  help  to  look  at  the  switches
  53.               supported by the command which failed.
  54.  
  55.        Command not implemented  (E43)
  56.            You  attempted  to  use  a DOS command  which  is  not
  57.            currently supported by MacDOS.
  58.            Suggested actions:
  59.            •  Protest  with  Rainbow Hill. If we received  enough
  60.               protests, we might implement it in a future release.
  61.  
  62.        Command only executable in batch  (E46)
  63.            You typed a command which is only executable within  a
  64.            batch  program. Currently, only GOTO, IF, NEXT, PAUSE,
  65.            and SHIFT return this error.
  66.            Suggested actions:
  67.            •  Re-examine what you intended to do and perhaps write
  68.               a small batch program.
  69.  
  70.        Dimensioning: prompt too long  (E15)
  71.            You   attempted  to  set  a  prompt  longer  than  199
  72.            characters.  Do you really want to be  prompted  by  a
  73.            couple of lines of text after typing each command?
  74.            Suggested actions:
  75.            •  Be sensible!
  76.  
  77.        Dimensioning: too many arguments  (E6)
  78.            You  entered a command with 24 or more parameters  and
  79.            switches.
  80.            Suggested actions:
  81.            •  Check  whether some switches appear more than  once
  82.               and  get  rid  of the duplicates. If there  are  no
  83.               duplicates, could you please tell Rainbow Hill what
  84.               command you typed?
  85.  
  86.        Dimensioning: too many commands  (E5)
  87.            MacDOS counted more than 8 commands separated by pipes
  88.            in a single line.
  89.            Suggested actions:
  90.            •  Break  up  the  chain of piped filters  by  storing
  91.               intermediate results into disk files.
  92.  
  93.        Dimensioning: too many tokens  (E2)
  94.            Your command line contained 64 tokens or more.
  95.            Suggested actions:
  96.            •  This  situation is very unlikely to occur,  because
  97.               MacDOS  limits  the  input  to  a  length  of   199
  98.               characters.  Please,  inform Rainbow  Hill  of  the
  99.               command which caused the problem.
  100.  
  101.        Directory name missing  (E23)
  102.            You entered without parameters a command which expected
  103.            a folder name as a parameter.
  104.            Suggested actions:
  105.            •  Re-examine what you were trying to do. You probably
  106.               typed  MKDIR  \ or RMDIR \ . If that is  the  case,
  107.               remember  that  you  cannot  ever  remove  a   root
  108.               directory.
  109.  
  110.        Directory specified  (E53)
  111.            MacDOS  found a directory when it expected to  find  a
  112.            file.
  113.            Suggested actions:
  114.            •  If  you  were executing an XCOPY command, you  will
  115.               find that a file in the source and a folder in  the
  116.               destination have the same name. XCOPY then  returns
  117.               this error when it attempts to replace the folder in
  118.               the  destination.  Rename the file  or  remove  the
  119.               folder.
  120.  
  121.        Disk full  (E80)
  122.            MacDOS could not create or extend a file because there
  123.            is not enough space on the requested volume. Note that
  124.            when  MacDOS  needs to overwrite a file  during  aCOPY
  125.            operation, it first creates a new file with a temporary
  126.            name.
  127.            Suggested actions:
  128.            •  Make some space by removing existing files.
  129.  
  130.        DOS command not implemented  (E1)
  131.            You  attempted  to  use  a DOS command  which  is  not
  132.            supported by MacDOS.
  133.            Suggested actions:
  134.            •  Protest with Rainbow Hill, although the chances that
  135.               you  are  going  to get this command  in  a  future
  136.               release are slim.
  137.  
  138.        Double initialisation of pipes  (E90, pipeDoubleInitErr)
  139.            MacDOS   attempted  to  initialise  twice   the   pipe
  140.            mechanism.  This  might  be  due  to  MacDOS'   memory
  141.            partition being corrupted.
  142.            Suggested actions:
  143.            •  This  situation should never occur.  Start  logging
  144.               with  LOG/O, attempt to reproduce the problem, and,
  145.               if  successful, send a listing of the log  file  to
  146.               Rainbow Hill.
  147.            •  Quit and re-launch MacDOS.
  148.  
  149.        Duplicate file name and version  (E48)
  150.            Up  to  release  0.2.0,  MacDOS  returned  this  error
  151.            whenever a File Manager call returned the Mac OS error
  152.            -48  (dupFNErr).  This occurs whenever  one  tries  to
  153.            rename  a file or create a directory and an item  with
  154.            the same name in the same folder already exists. After
  155.            0.2.0  this  errors have all been  trapped  with   E58
  156.            Duplicate filename(s).
  157.            Suggested actions:
  158.            •  Upgrade to the latest release or refer to E58.
  159.  
  160.        Duplicate filename(s)  (E58)
  161.            You  attempted to create a directory or rename a  file
  162.            when an item with the same name and in the same folder
  163.            already existed.
  164.            Suggested actions:
  165.            •  Either you use a different name, or you rename  the
  166.               existing item, or you operate in a different folder.
  167.  
  168.        Error when following a path  (E17)
  169.            MacDOS could not follow a chain of folder names  given
  170.            in a command parameter.
  171.            Suggested actions:
  172.            •  Check  that you did not attempt to "back up" higher
  173.               than the root directory of a particular volume. This
  174.               happens when you type too many up-one-level-strings
  175.               (ie. "..\") in a path.
  176.  
  177.        File already open for writing  (E77)
  178.            You attempted to OPEN a file already opened by another
  179.            application in exclusive mode.
  180.            Suggested actions:
  181.            •  Check that you correctly typed filename [and path].
  182.            •  Check  that you are not LOGging into that file  and
  183.               remember that only files opened with OPEN are listed
  184.               when you type OPEN without parameters (ie. the file
  185.               used for logging is opened internally by MacDOS and
  186.               does not appear in the list).
  187.            •  If you are convinced that the file should be closed,
  188.               quit  the  application which opened it  last.  That
  189.               application  might have erroneously left  the  file
  190.               open   (a  bug).  If  in  doubt,  close  all  other
  191.               applications before attempting to open the file with
  192.               MacDOS.
  193.  
  194.        File busy, dir non empty, or path error  (E49)
  195.            MacDOS attempted to access or remove an open file or to
  196.            remove a folder which was not empty.
  197.            Suggested actions:
  198.            •  Check  that no other application is using the  file
  199.               that  you  were trying to access. If this does  not
  200.               work, close all other applications, because some of
  201.               them might have a bug and hold onto files.
  202.            •  If you got this error message while trying to remove
  203.               a  folder  with  RMDIR, empty it  by  deleting  its
  204.               content  and then try to remove it once more.  Note
  205.               that  the  folder might contain an invisible  file,
  206.               like those used to show folders with custom icons.
  207.            •  If  your command contained a path, check that it is
  208.               correct: you might have been accessing an item with
  209.               the correct name but in the wrong folder.
  210.  
  211.        File not opened by the user  (E3)
  212.            You attempted to access with READ or WRITE a file which
  213.            you did not open with OPEN. Remember that MacDOS closes
  214.            the file when you read past the EOF.
  215.            Suggested actions:
  216.            •  Check  that you typed the correct fileID  and  type
  217.               OPEN  without parameters to see whether some  other
  218.               files are open.
  219.            •  Open the file before attempting to access it again.
  220.  
  221.        File open for writing  (E75)
  222.            You attempted to READ from a file OPENed for writing.
  223.            Suggested actions:
  224.            •  Check  that you typed the correct fileID  and  type
  225.               OPEN  without parameters to see whether some  other
  226.               files are open.
  227.  
  228.        File open for reading  (E74)
  229.            You attempted to WRITE into a file OPENed for reading.
  230.            Suggested actions:
  231.            •  Check  that you typed the correct fileID  and  type
  232.               OPEN  without parameters to see whether some  other
  233.               files are open.
  234.  
  235.        File or directory not found  (E27)
  236.            MacDOS  could not find the item you wanted to  operate
  237.            on.
  238.            Suggested actions:
  239.            •  If  your  command contained a path, check  that  it
  240.               specifies  the correct folder: you might have  been
  241.               looking for something which exists somewhere else.
  242.            •  If you were specifying a wildcarded name, this error
  243.               could   simply  mean  that  no  name  matched   the
  244.               wildcarding.
  245.  
  246.        Filter error  (E70, pipeFilteringErr)
  247.            During execution of a command containing pipes, one of
  248.            the filters reported to MacDOS a generic error.
  249.            Suggested actions:
  250.            •  If you are developing a filter, always try to report
  251.               specific errors or at least associate a proprietary
  252.               error  message  to the generic error  code.  Please
  253.               refer to Appendix B for help.
  254.  
  255.        Filter sent a command that only MacDOS should issue
  256.        (E92, pipeComFilterE)
  257.            While  performing a command containing  pipes,  MacDOS
  258.            received  from a filter a message of a type  which  is
  259.            normally used by MacDOS itself to configure a chain of
  260.            filters.
  261.            Suggested actions:
  262.            •  You have probably used the wrong command code while
  263.               modifying  pipe.c or pipe.h. You should not  modify
  264.               those files. Please refer to Appendix B for help.
  265.  
  266.        Filter  sent  a  data  message out of  a  sequence   (E93,
  267.        pipeSequenceE)
  268.            While  performing a command containing  pipes,  MacDOS
  269.            received  a  data  message with  an  invalid  sequence
  270.            number.
  271.            Suggested actions:
  272.            •  You have probably dropped a message in your filter.
  273.               Remember  that you have to forward to the  outgoing
  274.               pipe  a  message for each message that you  receive
  275.               from the incoming pipe.
  276.            •  If  you  were modifying pipe.c or pipe.h, you  have
  277.               probably corrupted the variable used for storing the
  278.               last  sequence number. You should not modify  those
  279.               files. Please refer to Appendix B for help.
  280.  
  281.        Filter sent downstream a message that should only be  sent
  282.        upstream
  283.        (E101, pipeDownstreamErr)
  284.            While  performing a command containing  pipes,  MacDOS
  285.            received  an error message through the PPC  port  that
  286.            should only deliver data messages.
  287.            Suggested actions:
  288.            •  You have probably caused the problem by incorrectly
  289.               updating  pipe.c or pipe.h. You should  not  modify
  290.               those files. Please refer to Appendix B for help.
  291.  
  292.        Filter  sent upstream a message that should only  be  sent
  293.        downstream
  294.        (E100, pipeUpstreamErr)
  295.            While  performing a command containing  pipes,  MacDOS
  296.            received  a  data message through the  PPC  port  that
  297.            should only deliver error messages.
  298.            Suggested actions:
  299.            •  You have probably caused the problem by incorrectly
  300.               updating  pipe.c or pipe.h. You should  not  modify
  301.               those files. Please refer to Appendix B for help.
  302.  
  303.        Folders named Desktop Folder and Trash cannot be created or
  304.        removed  (E73)
  305.            These two names are reserved.
  306.            Suggested actions:
  307.            •  Slightly  change  the  name  so  that  it   becomes
  308.               acceptable. Something like Desktop-Folder and Trash-
  309.               Can would be ok. Remember that file and folder names
  310.               are  case insensitive. Therefore, changing to lower
  311.               case would not help.
  312.  
  313.        The command cannot be piped  (E79)
  314.            You tried to pipe the output of something that does not
  315.            allow  output  redirection (eg. an application  or  an
  316.            AppleScript).  You can pipe the output of  a  standard
  317.            FOR, but only to the command MORE.
  318.            Suggested actions:
  319.            •  You   would   probably  achieve  your  purpose   by
  320.               redirecting  the output to a file. You  could  then
  321.               READ  and  operate on one line of text  at  a  time
  322.               within a batch program.
  323.            •  Check that you have not used a normal application in
  324.               place of a MacDOS filter.
  325.  
  326.        Hardware volume lock  (E51)
  327.            MacDOS could not operate on an item because the volume
  328.            had the "write-protect" switch ON.
  329.            Suggested actions:
  330.            •  Check  that you are operating on the correct volume
  331.               and  be  sure  that you know what  you  are  doing.
  332.               Usually, write protection has a reason to exist. If
  333.               you  really  want  to do it, eject  the  cartridge,
  334.               remove its write protection, and re-insert it  into
  335.               the drive before repeating the command.
  336.  
  337.        I/O error in disk operation  (E56)
  338.            MacDOS  could not complete a write or verify operation
  339.            when  copying or verifying a file. The number of bytes
  340.            written  or  read  back  was  lower  than  the  number
  341.            requested. The destination file was left corrupted.
  342.            Suggested actions:
  343.            •  Attempt to save critical files to a different volume
  344.               before doing anything else.
  345.            •  Reformat  or  run  a diagnostic on the  destination
  346.               volume before using it again.
  347.  
  348.        Illegal wildcarding  (E34)
  349.            MacDOS was given a wildcarded filename when it expected
  350.            to operate on an individual file.
  351.            The  most likely cause is that you specified a  folder
  352.            name as a parameter of a command which expected a file
  353.            name. Then MacDOS attempted to operate on all files in
  354.            the folder.
  355.            Another  possible  explanation is that  you  passed  a
  356.            wildcarded filename to XCOPY (which only accepts folder
  357.            names).
  358.            Suggested actions:
  359.            •  Review  what your intentions were and check whether
  360.               you  passed the correct type of parameters  to  the
  361.               command you used.
  362.  
  363.        Internal I/O error  (E33)
  364.            MacDOS   encountered  an  inconsistency   when   using
  365.            internally defined global parameters. For example,  it
  366.            might have attempted to use an invalid file ID or a non-
  367.            existing batch label.
  368.            This  might  be due to MacDOS' memory partition  being
  369.            corrupted.
  370.            Suggested actions:
  371.            •  This  situation should never occur.  Start  logging
  372.               with  LOG/O, attempt to reproduce the problem, and,
  373.               if  successful, send a listing of the log  file  to
  374.               Rainbow Hill.
  375.            •  Quit and re-launch MacDOS.
  376.  
  377.        Internal: unknown com state  (E10)
  378.        Internal: unknown token  (E25)
  379.            MacDOS  encountered an unknown state  or  token  while
  380.            parsing  a  command. This is likely to be  a  case  of
  381.            corrupted memory.
  382.            Suggested actions:
  383.            •  This  situation should never occur. Please,  inform
  384.               Rainbow  Hill  of  the  command  which  caused  the
  385.               problem.
  386.  
  387.        Invalid date or date format  (E47)
  388.            Either you attempted to set an impossible date or date
  389.            format,  or a new date did not conform to the  current
  390.            date format.
  391.            Suggested actions:
  392.            •  Check  that year, month, and day were in the  order
  393.               specified by the current date format (eg.  03/25/96
  394.               exists in the USA but not in Australia). Also check
  395.               that the separators were correct.
  396.            •  Check that the specified day exists (eg. 94/11/31 or
  397.               95/02/29 do not exist).
  398.            •  check that the year is in the interval 1904 to 2040.
  399.            •  If  you were entering a new date format, check that
  400.               you  only used the characters Y, M, and D plus  two
  401.               special characters as separators.
  402.  
  403.        Invalid prompt switch  (E14)
  404.            MacDOS  did  not  recognise all format  specifications
  405.            included in your PROMPT command.
  406.            Suggested actions:
  407.            •  Ensure that each character immediately following  a
  408.               dollar  sign  is  recognised by  DOS  as  a  format
  409.               specification. Remember that you have to  type  two
  410.               consecutive dollars if you want to include a '$' in
  411.               your prompt.
  412.  
  413.        Invalid session reference number  (E85, noSessionErr)
  414.            During execution of a command containing pipes, one of
  415.            the filters attempted to address a PPC session that was
  416.            not initialised.
  417.            Suggested actions:
  418.            •  You have probably caused the problem by incorrectly
  419.               updating  pipe.c or pipe.h. You should  not  modify
  420.               those files. Please refer to Appendix B for help.
  421.  
  422.        Invalid time  (E52)
  423.            The new time given to MacDOS was wrong.
  424.            Suggested actions:
  425.            •  Check that the specified time exists (eg. 13:20p, or
  426.               25:00 do not exist).
  427.  
  428.        Label not found  (E44)
  429.            While  running in batch, MacDOS could not  complete  a
  430.            command containing a label because it did not find the
  431.            label in the current batch program.
  432.            Suggested actions:
  433.            •  If the command that failed was a REPEAT, replace it
  434.               with a GOTO.
  435.            •  If  the command that failed was a GOTO, ensure that
  436.               the  destination label actually exists in the  same
  437.               batch file.
  438.            •  If you were executing a batch without echo, comment
  439.               out the ECHO OFF command in the batch file in order
  440.               to  determine which command is causing  the  error.
  441.               With ALARM ON, MacDOS actually tells you the name of
  442.               the label which could not be found.
  443.  
  444.        Label used for more than one loop  (E59)
  445.            MacDOS  found  that two REPEAT commands contained  the
  446.            same label name.
  447.            Suggested actions:
  448.            •  Replace the REPEATs with GOTOs.
  449.  
  450.        Labels are only allowed in batch mode  (E96)
  451.            You entered a label interactively.
  452.            Suggested actions:
  453.            •  Just  don't do it. In any case, what is the purpose
  454.               of  typing a label if you cannot use a GOTO to jump
  455.               to it?
  456.  
  457.        Labels must not begin with a percent sign  (E65)
  458.            MacDOS found a label which begins with a percent sign.
  459.            Suggested actions:
  460.            •  Change the offending label name.
  461.  
  462.        Licence number and/or user identification corrupted.
  463.        Please reload MacDOS from the original disk.  (E67)
  464.            MacDOS  could  not  decode the string  which  normally
  465.            contains licence number and user name.
  466.            Suggested actions:
  467.            •  Overwrite  the  faulty copy  of  MacDOS  with  that
  468.               contained in the original disk.
  469.  
  470.        Line parsing error  (E9)
  471.            MacDOS could not parse the command line. Perhaps,  you
  472.            typed some non-printing characters.
  473.            Suggested actions:
  474.            •  Retype  the command (ie. do not recall it with  up-
  475.               arrow). If the problem persists, please report it to
  476.               Rainbow Hill.
  477.  
  478.        MacDOS error ...  (the dots indicate a number)
  479.            An  error message which provides a code instead  of  a
  480.            message  in  clear should never occur. This  indicates
  481.            that  the  TEXT resource containing all error messages
  482.            does  not contain a message corresponding to the given
  483.            code.
  484.            Suggested actions:
  485.            •  Unless  you  have  modified the TEXT  resources  of
  486.               MacDOS, please report the problem to Rainbow Hill.
  487.  
  488.        MacDOS requires System 6.0.4 or greater  (E38)
  489.            MacDOS discovered that the system you are using on your
  490.            Mac  does  not  contain  the  Gestalt  facility.  This
  491.            facility  is necessary in order to properly  configure
  492.            MacDOS.
  493.            Suggested actions:
  494.            •  Upgrade  to the latest system 6 (ie. 6.0.8)  or  to
  495.               system 7.
  496.  
  497.        MacOS error  (E24)
  498.            A  system  trap returned to MacDOS an error  code  for
  499.            which MacDOS does not have a message in clear.
  500.            Suggested actions:
  501.            •  If  you liked MacDOS to be able to display a  clear
  502.               message rather than a mysterious number, please send
  503.               the  code to Rainbow Hill. Perhaps the next release
  504.               of MacDOS will then respond to that error condition
  505.               with  a  message in clear. If you decide to do  so,
  506.               please   send  together  with  the  error  code   a
  507.               description  of the circumstances under  which  the
  508.               error was reported.
  509.  
  510.        Max length of filename exceeded  (E26)
  511.            You  specified  a file or folder name longer  than  31
  512.            characters.
  513.            Suggested actions:
  514.            •  Use a shorter name.
  515.  
  516.        Maximum line length exceeded  (E76)
  517.            MacDOS  detected  a  line  of  text  longer  than  199
  518.            characters.  In batch, this might have happened  after
  519.            variable names where replaced with their content.
  520.            Suggested actions:
  521.            •  Create  new  variables which only contain  what  is
  522.               strictly necessary for the task at hand.
  523.            •  If  your variables contain folder names, use CD  to
  524.               move down the path and use relative paths.
  525.  
  526.        Maximum number of directories exceeded  (E20)
  527.            MacDOS attempted to access a folder too deep. Only  31
  528.            levels of folders are supported by MacDOS.
  529.            Suggested actions:
  530.            •  Attach  to  an intermediate folder, so that  MacDOS
  531.               does not need to go so deep.
  532.            •  Flatten the folder tree structure by moving  one of
  533.               the  deepest folders up one level. For example,  if
  534.               folder A contains B which contains C, move C out of
  535.               B so that both B and C are contained in A.
  536.  
  537.        Maximum number of volumes exceeded  (E18)
  538.            You   attempted  to  handle  more  than   31   volumes
  539.            simultaneously.
  540.            Suggested actions:
  541.            •  Do  you really need to have simultaneous access  to
  542.               more than 31 volumes? You can probably EJECT some of
  543.               the  volumes  (which is equivalent to trashing  the
  544.               volume icons).
  545.  
  546.        Memory mode is 32-bit, but application is not 32-bit clean
  547.        (E31)
  548.            Suggested actions:
  549.            •  Change  the  memory  mode or,  better,  remove  the
  550.               application from your system. Perhaps a new release
  551.               of the same application is 32-bit clean.
  552.  
  553.        Mismatch when verifying data written to disk  (E57)
  554.            MacDOS found that the data read back in order to verify
  555.            a  copy  operation did not match what  was  originally
  556.            written.
  557.            The   destination  file  of  the  copy  operation  was
  558.            corrupted.
  559.            Suggested actions:
  560.            •  Attempt to save critical files to a different volume
  561.               before doing anything else.
  562.            •  Re-format  or  run a diagnostic on the  destination
  563.               volume before using it again.
  564.  
  565.